home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-02
/
proclist.zip
/
PROCLIST.DOC
< prev
next >
Wrap
Text File
|
1991-03-09
|
4KB
|
91 lines
PROCLIST is a little utility designed to assist the programmer
using Turbo Pascal. If you are not writing programs OR you are not using
some kind of Pascal compiler then this program is of absolutely NO use to
you and you may as well erase PROCLIST and this DOC file.
Assuming you are writing source code in Pascal (Turbo or otherwise)
this little program parses your code line-by-line and identifies the
LINE NUMBER in your code where you define or create a procedure or function.
Unlike a lot of cross-reference programs, this one does NOT find every
instance of a call to a procedure or function, but rather only the line
number where you defined the procedure. It finds the line number where a
block of code like this STARTS:
Procedure MyProc;
var
....
begin
.....
.....
end;
PROCLIST produces a LIST (aha!) of all the procedures in your source code
with the first line number where the procedure is created, like this:
MyFirstProc........[MAINFILE.PAS].............. 445
MySecondProc.......[MAINFILE.PAS].............. 227
YourProc...........[XTRAFILE.INC].............. 23
The list of procedures is sorted alphabetically by name. PROCLIST then
produces another similar list of FUNCTIONS in your source code.
If you have failed to define any procedures or functions in a given
source code file, PROCLIST will fail to produce anything. For example,
it is a common programming practice to have an include file where you
declare all the variables you are using, but no procedures or functions
are defined in that file. In this case PROCLIST will not produce a
printout, although it is a perfectly valid programming practice as far
as your compiler is concerned.
When referencing line numbers, remember that line numbers
shown in the lisiting are RELATIVE to the file being parsed. If
you elect to have "include" files parsed with the main file, line
numbers shown will be specific for the file noted. In the example
above line 23 means line 23 in the file XTRAFILE.INC and NOT with
reference to line numbering in MAINFILE.PAS.
PROCLIST is menu driven and easy to use. When the first directory
screen comes up, you can type and enter "*.pas" or "*.inc" etc. (without
the double quotes) to filter the directory list. Press <Esc> at any time
to instantly abandon PROCLIST.
You can sort the directory list on the screen by pressing any of
several Alt-key combinations, such as Alt-S to sort by size of file. Press
F1 to see a Help screen of all the various Alt-key combinations. To use these
keys hold down the key labeled Alt and press the other key at the same time.
You can choose whether PROCLIST's output is sent to the printer
or to a disk file. If you choose printer, please be sure your printer
is on line, etc. If you send it to a diskfile, PROCLIST creates a text
file with the extension .PFX (procedure-function crossref). In our
example, the file MAINFILE.PFX would be written.
**************************************************************************
There are no fees requested or expected for PROCLIST. This one is
on the house.
If you do a lot of programming and debugging you may find our
utilities SHORTQ and FILEQ of benefit. PROCLIST is actually a modified
module from SHORTQ. SHORTQ and FILEQ will print your entire source code
file to printer with page headers, page numbers, with or without line
numbers, with or without include files and then produce a PROCLIST type
report at the end. (In the case of SHORTQ, the proclist reports reference
page number in the printed listing rather than line numbers because it's
easier to flip to a page to see your procedure code.) SHORTQ supports
other languages besides Pascal (i.e., the page header), but it won't
cross reference functions for any language but Pascal.
SHORTQ may also be available wherever you got PROCLIST.
FILEQ does what SHORTQ does for a QUEUE of files.
Write and ask about our other utilities.
John A. Abele
114 Woodlawn Ave.
Willow Grove, Pa. 19090